v1.77.8

Compare Source

• No user-visible changes.

v1.77.7

Compare Source

• Declarations that appear after nested rules are deprecated, because the
  semantics Sass has historically used are different from the semantics
  specified by CSS. In the future, Sass will adopt the standard CSS semantics.

  See the Sass website for details.

• Potentially breaking bug fix: // in certain places such as unknown
  at-rule values was being preserved in the CSS output, leading to potentially
  invalid CSS. It's now properly parsed as a silent comment and omitted from the
  CSS output.

v1.77.6

Compare Source

• Fix a few cases where comments and occasionally even whitespace wasn't allowed
  between the end of Sass statements and the following semicolon.

v1.77.5

Compare Source

• Fully trim redundant selectors generated by @extend.

v1.77.4

Compare Source

Embedded Sass

• Support passing Version input for fatalDeprecations as string over
  embedded protocol.

• Fix a bug in the JS Embedded Host where Version could be incorrectly accepted
  as input for silenceDeprecations and futureDeprecations in pure JS.

v1.77.3

Compare Source

Dart API

• Deprecation.duplicateVariableFlags has been deprecated and replaced with
  Deprecation.duplicateVarFlags to make it consistent with the
  duplicate-var-flags name used on the command line and in the JS API.

v1.77.2

Compare Source

• Don't emit deprecation warnings for functions and mixins beginning with __.

• Allow user-defined functions whose names begin with _ and otherwise look
  like vendor-prefixed functions with special CSS syntax.

Command-Line Interface

• Properly handle the --silence-deprecation flag.

• Handle the --fatal-deprecation and --future-deprecation flags for
  --interactive mode.

v1.77.1

Compare Source

• Fix a crash that could come up with importers in certain contexts.

v1.77.0

Compare Source

• Don't throw errors for at-rules in keyframe blocks.

v1.76.0

Compare Source

• Throw errors for misplaced statements in keyframe blocks.

• Mixins and functions whose names begin with -- are now deprecated for
  forwards-compatibility with the in-progress CSS functions and mixins spec.
  This deprecation is named css-function-mixin.

v1.75.0

Compare Source

• Fix a bug in which stylesheet canonicalization could be cached incorrectly
  when custom importers or the Node.js package importer made decisions based on
  the URL of the containing stylesheet.

JS API

• Allow importer to be passed without url in StringOptionsWithImporter.

v1.74.1

Compare Source

• No user-visible changes.

v1.72.0

Compare Source

• Support adjacent /s without whitespace in between when parsing plain CSS
  expressions.

• Allow the Node.js pkg: importer to load Sass stylesheets for package.json
exports field entries without extensions.

• When printing suggestions for variables, use underscores in variable names
  when the original usage used underscores.

JavaScript API

• Properly resolve pkg: imports with the Node.js package importer when
  arguments are passed to the JavaScript process.

v1.71.1

Compare Source

Command-Line Interface

• Ship the musl Linux release with the proper Dart executable.

JavaScript API

• Export the NodePackageImporter class in ESM mode.

• Allow NodePackageImporter to locate a default directory even when the
  entrypoint is an ESM module.

Dart API

• Make passing a null argument to NodePackageImporter() a static error rather
  than just a runtime error.

Embedded Sass

• In the JS Embedded Host, properly install the musl Linux embedded compiler
  when running on musl Linux.

v1.71.0

Compare Source

For more information about pkg: importers, see the
announcement on the Sass blog.

Command-Line Interface

• Add a --pkg-importer flag to enable built-in pkg: importers. Currently
  this only supports the Node.js package resolution algorithm, via
  --pkg-importer=node. For example, @use "pkg:bootstrap" will load
  node_modules/bootstrap/scss/bootstrap.scss.

JavaScript API

• Add a NodePackageImporter importer that can be passed to the importers
  option. This loads files using the pkg: URL scheme according to the Node.js
  package resolution algorithm. For example, @use "pkg:bootstrap" will load
  node_modules/bootstrap/scss/bootstrap.scss. The constructor takes a single
  optional argument, which indicates the base directory to use when locating
  node_modules directories. It defaults to
  path.dirname(require.main.filename).

Dart API

• Add a NodePackageImporter importer that can be passed to the importers
  option. This loads files using the pkg: URL scheme according to the Node.js
  package resolution algorithm. For example, @use "pkg:bootstrap" will load
  node_modules/bootstrap/scss/bootstrap.scss. The constructor takes a single
  argument, which indicates the base directory to use when locating
  node_modules directories.

v1.70.0

Compare Source

JavaScript API

• Add a sass.initCompiler() function that returns a sass.Compiler object
  which supports compile() and compileString() methods with the same API as
  the global Sass object. On the Node.js embedded host, each sass.Compiler
  object uses a single long-lived subprocess, making compiling multiple
  stylesheets much more efficient.

• Add a sass.initAsyncCompiler() function that returns a sass.AsyncCompiler
  object which supports compileAsync() and compileStringAsync() methods with
  the same API as the global Sass object. On the Node.js embedded host, each
  sass.AsynCompiler object uses a single long-lived subprocess, making
  compiling multiple stylesheets much more efficient.

Embedded Sass

• Support the CompileRequest.silent field. This allows compilations with no
  logging to avoid unnecessary request/response cycles.

• The Dart Sass embedded compiler now reports its name as "dart-sass" rather
  than "Dart Sass", to match the JS API's info field.

v1.69.7

Compare Source

Embedded Sass

• In the JS Embedded Host, properly install the x64 Dart Sass executable on
  ARM64 Windows.

v1.69.6

Compare Source

• Produce better output for numbers with complex units in meta.inspect() and
  debugging messages.

• Escape U+007F DELETE when serializing strings.

• When generating CSS error messages to display in-browser, escape all code
  points that aren't in the US-ASCII region. Previously only code points U+0100
  LATIN CAPITAL LETTER A WITH MACRON were escaped.

• Provide official releases for musl LibC and for Android.

• Don't crash when running meta.apply() in asynchronous mode.

JS API

• Fix a bug where certain exceptions could produce SourceSpans that didn't
  follow the documented SourceSpan API.

v1.69.5

Compare Source

JS API

• Compatibility with Node.js 21.0.0.

v1.69.4

Compare Source

• No user-visible changes.

v1.69.3

Compare Source

Embedded Sass

• Fix TypeScript type locations in package.json.

v1.69.2

Compare Source

JS API

• Fix a bug where Sass crashed when running in the browser if there was a global
  variable named process.

v1.69.1

Compare Source

• No user-visible changes.

v1.69.0

Compare Source

• Add a meta.get-mixin() function that returns a mixin as a first-class Sass
  value.

• Add a meta.apply() mixin that includes a mixin value.

• Add a meta.module-mixins() function which returns a map from mixin names in
  a module to the first-class mixins that belong to those names.

• Add a meta.accepts-content() function which returns whether or not a mixin
  value can take a content block.

• Add support for the relative color syntax from CSS Color 5. This syntax
  cannot be used to create Sass color values. It is always emitted as-is in the
  CSS output.

Dart API

• Deprecate Deprecation.calcInterp since it was never actually emitted as a
  deprecation.

Embedded Sass

• Fix a rare race condition where the embedded compiler could freeze when a
  protocol error was immediately followed by another request.

v1.68.0

Compare Source

• Fix the source spans associated with the abs-percent deprecation.

JS API

• Non-filesystem importers can now set the nonCanonicalScheme field, which
  declares that one or more URL schemes (without :) will never be used for
  URLs returned by the canonicalize() method.

• Add a containingUrl field to the canonicalize() and findFileUrl()
  methods of importers, which is set to the canonical URL of the stylesheet that
  contains the current load. For filesystem importers, this is always set; for
  other importers, it's set only if the current load has no URL scheme, or if
  its URL scheme is declared as non-canonical by the importer.

Dart API

• Add AsyncImporter.isNonCanonicalScheme, which importers (async or sync) can
  use to indicate that a certain URL scheme will never be used for URLs returned
  by the canonicalize() method.

• Add AsyncImporter.containingUrl, which is set during calls to the
  canonicalize() method to the canonical URL of the stylesheet that contains
  the current load. This is set only if the current load has no URL scheme, or
  if its URL scheme is declared as non-canonical by the importer.

Embedded Sass

• The CalculationValue.interpolation field is deprecated and will be removed
  in a future version. It will no longer be set by the compiler, and if the host
  sets it it will be treated as equivalent to CalculationValue.string except
  that "(" and ")" will be added to the beginning and end of the string
  values.

• Properly include TypeScript types in the sass-embedded package.

v1.67.0

Compare Source

• All functions defined in CSS Values and Units 4 are now once again parsed as
  calculation objects: round(), mod(), rem(), sin(), cos(), tan(),
  asin(), acos(), atan(), atan2(), pow(), sqrt(), hypot(),
  log(), exp(), abs(), and sign().

  Unlike in 1.65.0, function calls are not locked into being parsed as
  calculations or plain Sass functions at parse-time. This means that
  user-defined functions will take precedence over CSS calculations of the same
  name. Although the function names calc() and clamp() are still forbidden,
  users may continue to freely define functions whose names overlap with other
  CSS calculations (including abs(), min(), max(), and round() whose
  names overlap with global Sass functions).

• Breaking change: As a consequence of the change in calculation parsing
  described above, calculation functions containing interpolation are now parsed
  more strictly than before. However, almost all interpolations that would
  have produced valid CSS will continue to work. The only exception is
  #{$variable}% which is not valid in Sass and is no longer valid in
  calculations. Instead of this, either use $variable directly and ensure it
  already has the % unit, or write ($variable * 1%).

• Potentially breaking bug fix: The importer used to load a given file is no
  longer used to load absolute URLs that appear in that file. This was
  unintented behavior that contradicted the Sass specification. Absolute URLs
  will now correctly be loaded only from the global importer list. This applies
  to the modern JS API, the Dart API, and the embedded protocol.

Embedded Sass

• Substantially improve the embedded compiler's performance when compiling many
  files or files that require many importer or function call round-trips with
  the embedded host.

v1.66.1

Compare Source

JS API

• Fix a bug where Sass compilation could crash in strict mode if passed a
  callback that threw a string, boolean, number, symbol, or bignum.

v1.66.0

Compare Source

• Breaking change: Drop support for the additional CSS calculations defined
  in CSS Values and Units 4. Custom Sass functions whose names overlapped with
  these new CSS functions were being parsed as CSS calculations instead, causing
  an unintentional breaking change outside our normal [compatibility policy] for
  CSS compatibility changes.

  Support will be added again in a future version, but only after Sass has
  emitted a deprecation warning for all functions that will break for at least
  three months prior to the breakage.

v1.65.1

Compare Source

• Update abs-percent deprecatedIn version to 1.65.0.

v1.65.0

Compare Source

• All functions defined in CSS Values and Units 4 are now parsed as calculation
  objects: round(), mod(), rem(), sin(), cos(), tan(), asin(),
  acos(), atan(), atan2(), pow(), sqrt(), hypot(), log(), exp(),
  abs(), and sign().

• Deprecate explicitly passing the % unit to the global abs() function. In
  future releases, this will emit a CSS abs() function to be resolved by the
  browser. This deprecation is named abs-percent.

v1.64.2

Compare Source

• No user-visible changes.

v1.64.1

Compare Source

Embedded Sass

• Fix a bug where a valid SassCalculation.clamp() with less than 3 arguments
  would throw an error.

v1.64.0

Compare Source

• Comments that appear before or between @use and @forward rules are now
  emitted in source order as much as possible, instead of always being emitted
  after the CSS of all module dependencies.

• Fix a bug where an interpolation in a custom property name crashed if the file
  was loaded by a @use nested in an @import.

JavaScript API

• Add a new SassCalculation type that represents the calculation objects added
  in Dart Sass 1.40.0.

• Add Value.assertCalculation(), which returns the value if it's a
  SassCalculation and throws an error otherwise.

• Produce a better error message when an environment that supports some Node.js
  APIs loads the browser entrypoint but attempts to access the filesystem.

Embedded Sass

• Fix a bug where nested relative @imports failed to load when using the
  deprecated functions render or renderSync and those relative imports were
  loaded multiple times across different files.